home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1996 May: Tool Chest / Developer CD Series May 1996 (Tool Chest) (Apple Computer) (1996).iso / Sample Code / Macintosh Sample Code / Sample Code Notes / SCN.011.GetZoneList < prev    next >
Encoding:
Text File  |  1994-11-18  |  2.4 KB  |  60 lines  |  [TEXT/MPS ]
  1. Macintosh
  2. Sample Code Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6. #11:    GetZoneList
  7.  
  8. Written by:    Mark Bennett & Pete Helme
  9.  
  10. Versions:        1.00                November 1988
  11.                 1.01                October 1989
  12.                 1.02                May 1990
  13.                 1.03                June 1992
  14.  
  15. Components:        GetZoneList.c        May 1, 1990
  16.                 GetZoneList.p        May 1, 1990
  17.                 GetZoneList.r        May 1, 1990
  18.                 Makefile            May 1, 1990
  19.  
  20. Required:        UFailure.a            November 1, 1988
  21.                 UFailure.h            November 1, 1988
  22.                 UFailure.incl.p        November 1, 1988
  23.                 UFailure.p            November 1, 1988
  24. _____________________________________________________________________________
  25.  
  26. This program needs MPW 3.2 or greater to build. It also requires that you
  27. copy the necessary files from the UFailure UNIT (originally distributed as
  28. part of SC.012.Signals) to the GetZoneList folder.
  29. _____________________________________________________________________________
  30.  
  31. GetZoneList is a sample application that uses AppleTalk's AppleTalk
  32. Transaction Protocol (ATP) and Zone Information Protocol (ZIP) to obtain a
  33. list of zones on an AppleTalk internet.  It also demonstrates using a signal,
  34. or failure-catching mechanism, to recover from error situations.
  35.  
  36. GetZoneList is based on Sample, and DTS recommends that you review Sample or
  37. TESample for the general structure and MultiFinder techniques you should use
  38. when writing a new application.
  39.  
  40. Changes for Version 1.02
  41. ________________________
  42.  
  43. A node exists on a valid internet if, and only if, 1) GetBridgeAddress
  44. returns a non-zero router address and 2) GetNodeAddress returns a non-zero
  45. network number.  If there is a valid network number, but no router, one
  46. cannot obtain zone information, and there cannot be a internet.  The
  47. previous version of GetZoneList only checked GetNodeAddress, which could
  48. show a non-zero network number in the presence of a half router.  This
  49. current version now makes the appropriate check in the procedure
  50. BuildZoneList.
  51.  
  52. Changes were also made to support AppleTalk Phase 2 in accordance with
  53. Technical Note #250, "AppleTalk Phase 2 on the Macintosh."  See procedures
  54. ZoneListCleanUpPhase2 and BuildZoneListPhase2.
  55.  
  56. Changes for Version 1.03
  57. ________________________
  58.  
  59. Since the MPW 3.2 AppleTalk.h header file contains AppleTalk Phase 2 data
  60. stuctures, the typedefs were removed and the header file types were used.